home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 3 / CU Amiga Magazine's Super CD-ROM 03 (1996)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1996-09].iso / misc / readers_utils / keyboot_v11.lha / KeyBoot / KeyBoot.doc < prev    next >
Text File  |  1996-06-21  |  7KB  |  172 lines
  1.  
  2.  
  3.                           ___________________________
  4.                          |                           |
  5.                          |       K E Y B O O T       |
  6.                          |                           |
  7.                          |        Version 1.1        |
  8.                          |                           |
  9.                          |   © 1996 by Paul Shandi   |
  10.                          |___________________________|
  11.  
  12.  
  13.  
  14.  --<  IMPORTANT NOTICE!  >--------------------------------------------------
  15.  
  16.  There was a SERIOUS bug in release 1.0 of this program, which caused it to
  17.  fail miserably!  Unfortunately I only noticed the bug after the program was
  18.  made public, so if you were turned off by KeyBoot due to this, rest assured
  19.  that this release works 100% correctly!  :)
  20.  
  21.  
  22.  
  23.  --<  INTRODUCTION  >-------------------------------------------------------
  24.  
  25.  "KeyBoot" is a handy little program that lets you boot your Amiga with one
  26.  of up to 10 different user-defined Startup-Sequences (hereafter called SS).
  27.  
  28.  All you do is hold down a Function Key (F1 - F10) during bootup and the
  29.  corresponding SS is run.  If you DON'T hold down a Function Key then your
  30.  normal SS is run instead.
  31.  
  32.  Note that this release of KeyBoot is ShareWare, and thus restricted to just
  33.  2 different SS's (the F1 and F2 keys).  To get access to all 10, you must
  34.  register... see the end of this doc for more info.
  35.  
  36.  
  37.  
  38.  --<  PROGRAM REQUIREMENTS  >-----------------------------------------------
  39.  
  40.  KeyBoot requires that you have Workbench 2.04 or higher, as does the
  41.  installer program that accompanies it.  You will also need the AmigaDOS
  42.  "Execute" command to be in the C dir of your boot disk.  The program was
  43.  intended for hard-drive users, but floppy users can also benefit.
  44.  
  45.  
  46.  
  47.  --<  USING AND INSTALLING THE PROGRAM  >-----------------------------------
  48.  
  49.  There are 5 files associated with the program, and they are:
  50.  
  51.  KeyBoot           -  The main program
  52.  KeyBoot.doc       -  This documentation
  53.  KeyBoot.doc.info  -  This documentation's icon
  54.  KB_Install        -  The installation program
  55.  KB_Install.info   -  The installation program's icon
  56.  
  57.  Firstly, the program requires that you have the "Execute" command on your
  58.  boot disk in the C directory.  This should be there already, as it's part
  59.  of Workbench's structure and will only be missing if you deleted it.  To
  60.  test if it's there, open a CLI and enter:
  61.  
  62.  version sys:c/execute
  63.  
  64.  If you get the message "object not found", then it's NOT there and needs
  65.  to be replaced from your original Workbench disk - consult your manual.
  66.  If it IS there, you'll get a message similar to "execute 37.11" (the number
  67.  might be different).
  68.  
  69.  Right, once you know "Execute" is there, you then must install the program
  70.  on your system.  This is just a matter of double-clicking the "KB_Install"
  71.  icon and following the prompts.  You'll be surprised how quick and easy it
  72.  is!  :)  Once the installation is done, you're all set to move on to the
  73.  next step: defining your own custom SS's!
  74.  
  75.  This is simplicity itself.  Simply write your own SS's as usual, but make
  76.  sure you store them in the S dir of your boot disk just like the normal
  77.  Startup-Sequence file.  However, you MUST name them as "StartupX" where the
  78.  "X" is a number from 1 to 10.
  79.  
  80.  Thus, if you had 2 custom SS's, you would call them "Startup1" and
  81.  "Startup2".  If you had a 10th SS, it would be called "Startup10".
  82.  
  83.  That's it!  If you now reboot your Amiga, and DON'T hold any Function Keys,
  84.  your system will boot up as normal.  However, if you hold down the F1 key,
  85.  then the "Startup1" script will be executed instead!  Fabulous!  :)
  86.  
  87.  
  88.  
  89.  --<  TROUBLESHOOTING  >----------------------------------------------------
  90.  
  91.  Q. What does "SS" mean in this document?
  92.  A. As stated at the start, it's short for "Startup-Sequence".  What I am
  93.     referring to is any user-written Startup-Sequence or AmigaDOS script.
  94.  
  95.  Q. My custom SS's aren't being executed.
  96.  A. Make sure they're in the S dir of your boot disk, and that you hold down
  97.     the corresponding Function Key until they start.  It could be that you
  98.     are not holding down the Function Key long enough at boot time.  You may
  99.     also have accidentally named them something else... remember, custom SS
  100.     number 2 must be named "Startup2" and so on.
  101.  
  102.  Q. When I hold down a Function Key, a blank Workbench screen appears.
  103.  A. There is no SS related to the Function Key you're holding.  For example,
  104.     this error occurs if you are holding F2 and no SS called "Startup2" is
  105.     in the S dir of your boot disk.
  106.  
  107.  Q. My Amiga keeps booting to a blank Workbench screen.
  108.  A. The "Execute" command is missing from your boot disk's C dir.  You'll
  109.     need to copy it over from your original Workbench disk to fix this.
  110.  
  111.  Q. My first 2 custom SS's are being executed, but 3rd to 10th aren't.
  112.  A. KeyBoot is ShareWare and only supports 2 custom SS's until you register.
  113.  
  114.  Q. I hate KeyBoot!  How do I restore my Amiga back to normal?
  115.  A. Open a CLI and enter these lines:
  116.  
  117.     delete sys:c/keyboot
  118.     delete sys:s/startup-sequence
  119.     rename sys:s/startup-default to sys:s/startup-sequence
  120.  
  121.     You can now reboot your Amiga to its original state.  It also means
  122.     you're stuck with one SS from now on!  :)
  123.  
  124.  
  125.  
  126.  --<  COPYRIGHT AND DISTRIBUTION  >-----------------------------------------
  127.  
  128.  "KeyBoot" is ShareWare.  This means anyone can spread the program where
  129.  they see fit.  You may upload it to BBS's, submit it to PD libraries, give
  130.  it to your friends; whatever.  However, it is NOT a PD product; the author
  131.  retains all copyrights to it, as well as this documentation.
  132.  
  133.  COMMERCIAL NOTE: Although this program can be freely distributed, it may
  134.  NOT be distributed as part of a commercial package under ANY circumstances!
  135.  Doing so will get you issued with a lawsuit, so don't consider it.  If you
  136.  would like to have it as part of a commercial package, contact me first.
  137.  The single and ONLY exception to this commercial-related rule is when the
  138.  program is to be included in a CD-ROM compilation of PD, ShareWare or
  139.  Freely Distributable software, such as the excellent Aminet CD collections.
  140.  
  141.  The program MUST be distributed with the following 5 files, of which NONE
  142.  may be altered or omitted:
  143.  
  144.  KeyBoot           -  The main program
  145.  KeyBoot.doc       -  This documentation
  146.  KeyBoot.doc.info  -  This documentation's icon
  147.  KB_Install        -  The installation program
  148.  KB_Install.info   -  The installation program's icon
  149.  
  150.  If you want access to all 10 Function Keys, and thus be able to execute 1
  151.  of 10 different SS's at bootup, just send the author the ShareWare fee of
  152.  $10 Australian Dollars to the PO Box listed below.  Please do NOT send
  153.  personal cheques or money orders, as Australian currency is preferred.
  154.  Posting an Australian $10 bill inside a greeting card is the best solution.
  155.  Include your name and address, and E-Mail address if you want the program
  156.  sent back to you by modem.  Thank you!  :)
  157.  
  158.  
  159.  
  160.  --<  CONTACTING THE AUTHOR  >----------------------------------------------
  161.  
  162.  You can contact me (Paul Shandi) via two methods:
  163.  
  164.  Normal: PO Box 1003, Dee Why, NSW, 2099, Australia
  165.  E-Mail: shandman@fl.net.au
  166.  
  167.  Please do so if you have any comments, bug reports, etc, about the program.
  168.  
  169.  ========================<  END OF DOCUMENTATION  >=========================
  170.  
  171.  
  172.